home *** CD-ROM | disk | FTP | other *** search
/ 3D Images / 3D Images.iso / programs / amiga / jpegv5 / doc / djpeg.man < prev    next >
Text File  |  1995-01-12  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4. DJPEG(1)                                                 DJPEG(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        djpeg - decompress a JPEG file to an image file
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ddjjppeegg [ _o_p_t_i_o_n_s ] [ _f_i_l_e_n_a_m_e ]
  12.  
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        ddjjppeegg  decompresses  the  named JPEG file, or the standard
  16.        input if no file is named, and produces an image  file  on
  17.        the  standard output.  PBMPLUS (PPM/PGM), BMP, GIF, Targa,
  18.        or  RLE  (Utah  Raster  Toolkit)  output  format  can   be
  19.        selected.   (RLE  is  supported only if the URT library is
  20.        available.)
  21.  
  22. OOPPTTIIOONNSS
  23.        All  switch  names  may  be  abbreviated;   for   example,
  24.        --ggrraayyssccaallee  may  be  written  --ggrraayy  or  --ggrr.  Most of the
  25.        "basic" switches can be abbreviated to as  little  as  one
  26.        letter.  Upper and lower case are equivalent (thus --GGIIFF is
  27.        the same as --ggiiff).  British spellings  are  also  accepted
  28.        (e.g.,  --ggrreeyyssccaallee), though for brevity these are not men­
  29.        tioned below.
  30.  
  31.        The basic switches are:
  32.  
  33.        --ccoolloorrss _N
  34.               Reduce image to at most N colors.  This reduces the
  35.               number  of colors used in the output image, so that
  36.               it can be displayed on  a  colormapped  display  or
  37.               stored  in a colormapped file format.  For example,
  38.               if you have an 8-bit display, you'd need to  reduce
  39.               to 256 or fewer colors.
  40.  
  41.        --qquuaannttiizzee _N
  42.               Same  as --ccoolloorrss.  --ccoolloorrss is the recommended name,
  43.               --qquuaannttiizzee is provided only for  backwards  compati­
  44.               bility.
  45.  
  46.        --ffaasstt  Select recommended processing options for fast, low
  47.               quality output.  (The default  options  are  chosen
  48.               for  highest  quality  output.)  Currently, this is
  49.               equivalent to --ddcctt ffaasstt --nnoossmmooootthh --oonneeppaassss  --ddiitthheerr
  50.               oorrddeerreedd.
  51.  
  52.        --ggrraayyssccaallee
  53.               Force gray-scale output even if JPEG file is color.
  54.               Useful for viewing on  monochrome  displays;  also,
  55.               ddjjppeegg runs noticeably faster in this mode.
  56.  
  57.        --ssccaallee _M_/_N
  58.               Scale  the output image by a factor M/N.  Currently
  59.               the scale factor must be 1/1,  1/2,  1/4,  or  1/8.
  60.               Scaling  is  handy if the image is larger than your
  61.  
  62.  
  63.  
  64.                           28 August 1994                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DJPEG(1)                                                 DJPEG(1)
  71.  
  72.  
  73.               screen; also, ddjjppeegg runs much faster  when  scaling
  74.               down the output.
  75.  
  76.        --bbmmpp   Select  BMP  output format (Windows flavor).  8-bit
  77.               colormapped  format  is  emitted  if   --ccoolloorrss   or
  78.               --ggrraayyssccaallee  is  specified,  or  if the JPEG file is
  79.               gray-scale; otherwise, 24-bit full-color format  is
  80.               emitted.
  81.  
  82.        --ggiiff   Select  GIF output format.  Since GIF does not sup­
  83.               port more than 256 colors, --ccoolloorrss 225566  is  assumed
  84.               (unless you specify a smaller number of colors).
  85.  
  86.        --ooss22   Select  BMP output format (OS/2 1.x flavor).  8-bit
  87.               colormapped  format  is  emitted  if   --ccoolloorrss   or
  88.               --ggrraayyssccaallee  is  specified,  or  if the JPEG file is
  89.               gray-scale; otherwise, 24-bit full-color format  is
  90.               emitted.
  91.  
  92.        --ppnnmm   Select PBMPLUS (PPM/PGM) output format (this is the
  93.               default format).  PGM is emitted if the  JPEG  file
  94.               is gray-scale or if --ggrraayyssccaallee is specified; other­
  95.               wise PPM is emitted.
  96.  
  97.        --rrllee   Select RLE output format.  (Requires URT  library.)
  98.  
  99.        --ttaarrggaa Select  Targa  output format.  Gray-scale format is
  100.               emitted if  the  JPEG  file  is  gray-scale  or  if
  101.               --ggrraayyssccaallee  is  specified;  otherwise,  colormapped
  102.               format is emitted if --ccoolloorrss is  specified;  other­
  103.               wise, 24-bit full-color format is emitted.
  104.  
  105.        Switches for advanced users:
  106.  
  107.        --ddcctt iinntt
  108.               Use integer DCT method (default).
  109.  
  110.        --ddcctt ffaasstt
  111.               Use fast integer DCT (less accurate).
  112.  
  113.        --ddcctt ffllooaatt
  114.               Use  floating-point DCT method.  The floating-point
  115.               method is the most accurate, but will be the  slow­
  116.               est  unless  your  machine  has very fast floating-
  117.               point hardware.  Also  note  that  results  of  the
  118.               floating-point  method  may  vary  slightly  across
  119.               machines, while the integer methods should give the
  120.               same  results  everywhere.  The fast integer method
  121.               is much less accurate than the other two.
  122.  
  123.        --ddiitthheerr ffss
  124.               Use Floyd-Steinberg dithering  in  color  quantiza­
  125.               tion.
  126.  
  127.  
  128.  
  129.  
  130.                           28 August 1994                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DJPEG(1)                                                 DJPEG(1)
  137.  
  138.  
  139.        --ddiitthheerr oorrddeerreedd
  140.               Use ordered dithering in color quantization.
  141.  
  142.        --ddiitthheerr nnoonnee
  143.               Do  not  use  dithering  in color quantization.  By
  144.               default, Floyd-Steinberg dithering is applied  when
  145.               quantizing  colors;  this  is slow but usually pro­
  146.               duces the best results.  Ordered dither is  a  com­
  147.               promise  between speed and quality; no dithering is
  148.               fast but usually  looks  awful.   Note  that  these
  149.               switches  have  no effect unless color quantization
  150.               is being done.  Ordered dither is only available in
  151.               --oonneeppaassss mode.
  152.  
  153.        --mmaapp _f_i_l_e
  154.               Quantize  to the colors used in the specified image
  155.               file.  This is useful for producing multiple  files
  156.               with  identical color maps, or for forcing a prede­
  157.               fined set of colors to be used.  The _f_i_l_e must be a
  158.               GIF  or PPM file. This option overrides --ccoolloorrss and
  159.               --oonneeppaassss.
  160.  
  161.        --nnoossmmooootthh
  162.               Use a faster, lower-quality upsampling routine.
  163.  
  164.        --oonneeppaassss
  165.               Use one-pass instead of  two-pass  color  quantiza­
  166.               tion.  The one-pass method is faster and needs less
  167.               memory, but  it  produces  a  lower-quality  image.
  168.               --oonneeppaassss  is ignored unless you also say --ccoolloorrss _N.
  169.               Also, the one-pass method is always used for  gray-
  170.               scale output (the two-pass method is no improvement
  171.               then).
  172.  
  173.        --mmaaxxmmeemmoorryy _N
  174.               Set limit for amount of memory to use in processing
  175.               large  images.   Value is in thousands of bytes, or
  176.               millions of bytes if "M" is attached to the number.
  177.               For  example,  --mmaaxx  44mm  selects 4000000 bytes.  If
  178.               more space is needed, temporary files will be used.
  179.  
  180.        --oouuttffiillee _n_a_m_e
  181.               Send  output  image to the named file, not to stan­
  182.               dard output.
  183.  
  184.        --vveerrbboossee
  185.               Enable debug printout.  More --vv's give more output.
  186.               Also, version information is printed at startup.
  187.  
  188.        --ddeebbuugg Same as --vveerrbboossee.
  189.  
  190. EEXXAAMMPPLLEESS
  191.        This example decompresses the JPEG file foo.jpg, automati­
  192.        cally quantizes to 256 colors, and saves the output in GIF
  193.  
  194.  
  195.  
  196.                           28 August 1994                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. DJPEG(1)                                                 DJPEG(1)
  203.  
  204.  
  205.        format in foo.gif:
  206.  
  207.               ddjjppeegg --ggiiff _f_o_o_._j_p_g >> _f_o_o_._g_i_f
  208.  
  209. HHIINNTTSS
  210.        To  get  a  quick  preview of an image, use the --ggrraayyssccaallee
  211.        and/or --ssccaallee switches.   --ggrraayyssccaallee  --ssccaallee  11//88  is  the
  212.        fastest case.
  213.  
  214.        Several options are available that trade off image quality
  215.        to gain speed.  --ffaasstt turns on the recommended settings.
  216.  
  217.        --ddcctt ffaasstt and/or --nnoossmmooootthh gain speed at a small sacrifice
  218.        in  quality.   When  producing  a  color-quantized  image,
  219.        --oonneeppaassss --ddiitthheerr oorrddeerreedd is fast but  much  lower  quality
  220.        than  the default behavior.  --ddiitthheerr nnoonnee may give accept­
  221.        able results in two-pass mode, but is seldom tolerable  in
  222.        one-pass mode.
  223.  
  224.        If  you  are  fortunate  enough to have very fast floating
  225.        point hardware, --ddcctt ffllooaatt may be even  faster  than  --ddcctt
  226.        ffaasstt.
  227.  
  228. EENNVVIIRROONNMMEENNTT
  229.        JJPPEEGGMMEEMM
  230.               If  this  environment variable is set, its value is
  231.               the default memory limit.  The value  is  specified
  232.               as  described  for  the --mmaaxxmmeemmoorryy switch.  JJPPEEGGMMEEMM
  233.               overrides the default value specified when the pro­
  234.               gram  was  compiled, and itself is overridden by an
  235.               explicit --mmaaxxmmeemmoorryy.
  236.  
  237. SSEEEE AALLSSOO
  238.        ccjjppeegg(1), rrddjjppggccoomm(1), wwrrjjppggccoomm(1)
  239.        ppppmm(5), ppggmm(5)
  240.        Wallace, Gregory K.  "The JPEG Still  Picture  Compression
  241.        Standard", Communications of the ACM, April 1991 (vol. 34,
  242.        no. 4), pp. 30-44.
  243.  
  244. AAUUTTHHOORR
  245.        Independent JPEG Group
  246.  
  247. BBUUGGSS
  248.        Arithmetic coding is not supported for legal reasons.
  249.  
  250.        Still not as fast as we'd like.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                           28 August 1994                        4
  263.  
  264.  
  265.